home *** CD-ROM | disk | FTP | other *** search
/ PC Direct 1995 May / PC Direct CD-ROM (May 1995).ISO / ipe / manuals / lc30 / lsc5.txt < prev   
Encoding:
Text File  |  1994-06-29  |  67.9 KB  |  1,539 lines

  1. LAN Support Center   
  2.   
  3. Copyright 1994, McAfee, Inc.  All rights reserved.  
  4.   
  5. ===========================
  6. Part Three: Reference Guide  
  7. ===========================  
  8.    
  9. 12.0  Error Messages  
  10.   
  11. This appendix lists the error messages associated with LSC.  All messages   
  12. are listed in alphabetical order.  
  13.   
  14.   
  15. 12.1  LSC Error Messages  
  16.   
  17. A reserved item cannot be edited or deleted.  
  18.     There are certain items in the qualification lists that are reserved   
  19.     or pre-defined, for instance, the "TO_DO" action code is reserved.  
  20.   
  21. Component, Operator, and Description fields must be filled in.  
  22.     To insert filter criteria for a query through Add Query or Edit Query   
  23.     dialog boxes, you need to select data for all three fields.  
  24.   
  25. Delete the action selected?  
  26.     LSC asks for your confirmation before deleting an action in the View   
  27.     Tickets window.  
  28.   
  29. Delete the Staff selected?  
  30.     LSC asks for your confirmation before deleting a staff in the Setup   
  31.     Staff dialog box.  
  32.   
  33. Delete the ticket selected?  
  34.     LSC asks for your confirmation before deleting a ticket from the   
  35.     database.  
  36.   
  37. Delete the View Name selected?  
  38.     LSC asks for your confirmation before deleting a view in the Custom   
  39.     View Settings dialog box.  
  40.   
  41. Do you want to delete this entry?  
  42.     LSC asks for your confirmation before deleting an entry in the   
  43.     Qualification Lists dialog box.  
  44.   
  45. Error: The date range is not valid.  
  46.     When entering the date range in the Filter Ticket List dialog box,   
  47.     the To date must be equal to or later than the From date.    
  48.   
  49. Error: Unable to create or open specified file.  
  50.     To archive tickets to a file or restore tickets from a file, LSC must   
  51.     create or open a file accordingly. This message occurs if the   
  52.     operation is unsuccessful.    
  53.   
  54. Extremely low in memory. Unable to invoke ticket window. Please close one or   
  55. more tickets to free up memory.  
  56.     As an MDI (Multiple Document Interface) application, LSC allows you   
  57.     to open more than one ticket window simultaneously. The maximum   
  58.     number of windows are limited to the PC's memory. When the threshold   
  59.     is reached, the message alerts you to close one or more 'least used'   
  60.     ticket.    
  61.   
  62. Field cannot be left empty.  
  63.     When editing an item in a qualification list, you cannot enter an   
  64.     empty string.  
  65.   
  66. Login incorrect.  Please try again or click the Cancel button to abort.  
  67.     The login initials and password combination provided is incorrect.    
  68.     You may retry or abort logging in to LSC.  
  69.   
  70. Please close all ticket windows before switching to view another set of   
  71. ticket database.  
  72.     LSC allows you to view either the current or a historical database.    
  73.     Before you switch from one to the other, you need to close all ticket   
  74.     windows to prevent database corruption.  
  75.   
  76. Please do not specify filename with .ACT, .DES, or .DEA extension.  
  77.     The ticket database is maintained in 3 files, HLPDSK1H.DAT,   
  78.     HLPDSK1A.DAT, HLPDSK1P.DAT and HLPDSK1T.DAT. When archiving tickets,   
  79.     you need to specify a filename (usually with the .ARC extension).    
  80.     The file will hold data from HLPDSK1H.DAT. LSC will use the same   
  81.     filename, but assign the .ACT extension to hold the data from   
  82.     HLPDSK1A.DAT, the .DES extension to hold the data from HLPDSK1P.DAT,   
  83.     and the .DEA extension to hold the data from HLPDSK1T.DAT.    
  84.     Consequently, the message occurs if you specify the .ACT file   
  85.     extension.  
  86.   
  87. Please provide a View Name.  
  88.     When defining or editing a custom view in the Custom View Settings   
  89.     dialog box, you need to name the view in order to save the   
  90.     configuration.  
  91.   
  92. Please provide the Account ID.  
  93.     When adding/editing the Account information, the Account ID field   
  94.     cannot be left empty.  
  95.   
  96. Please provide the Company ID.  
  97.     When adding/editing the Company information, the Company ID field   
  98.     cannot be left empty.  
  99.   
  100. Please provide the Staff Initials.  
  101.     When adding or editing the staff profile in the Setup Staff dialog   
  102.     box, you need to provide the staff initials. This message can also   
  103.     occur if you did not provide the initials for the Login dialog box.  
  104.   
  105. Please select a ticket on the View Tickets list first before the specified   
  106. operation can be completed.  
  107.     Before you try to perform a ticket-related operation (e.g., Add   
  108.     Action, Contact Details, Delete Ticket), you must first highlight a   
  109.     ticket on the View Tickets list by clicking on it.  
  110.   
  111. Please specify a Closed Date/Time which is equal or later than the Opened   
  112. Date/Time.  
  113.     When you close a ticket, you may only specify a Closed Date/Time   
  114.     that is later than the Opened Date/Time.  
  115.   
  116. Please specify a file for the archived tickets.  
  117.     To archive tickets, you need to specify a filename as the   
  118.     destination.  
  119.   
  120. The Account ID has already been used.  Please provide a different ID.  
  121.     When adding/editing Account information, the Account ID must be   
  122.     unique.  
  123.   
  124. The addition of this staff member will exceed the number of LSC users allowed   
  125. by your license. Please contact McAfee Associates to purchase additional   
  126. copies of the LSC software.  
  127.     You are attempting to add more staff than the number indicated by the   
  128.     LSC license you have purchased. You may increase the number of staff   
  129.     by upgrading your license. Please contact McAfee Associates.  
  130.   
  131. The Company ID has already been used.  Please provide a different ID.  
  132.     When adding/editing Company information, the Company ID must be   
  133.     unique.  
  134.   
  135. The current ticket is the first ticket in the database according to the   
  136. Filter/Sort criteria.  
  137.     When you choose the Previous tool bar button or choose the Previous   
  138.     Ticket command from the Ticket menu, LSC will search the database for   
  139.     the previous ticket according to the Filter/Sort order. This message   
  140.     appears if the present ticket displayed is the first ticket.  
  141.   
  142. The current ticket is the last ticket in the database according to the   
  143. Filter/Sort criteria.  
  144.     When you choose the Next tool bar button or choose the Next Ticket   
  145.     command from the Ticket menu, LSC will search the database for the   
  146.     next ticket according to the Filter/Sort order. This message appears   
  147.     if the present ticket displayed is the last ticket.  
  148.   
  149. The new password was not retyped correctly.  
  150.     When adding or editing the staff profile in the Setup Staff dialog   
  151.     box, the two password fields must be equivalent to confirm the choice.  
  152.   
  153. The number of view names included on the menu has reached the maximum.  
  154.     To accommodate the limited length of a pop-up menu, the maximum   
  155.     number of views that can appear on the View menu is ten (10). When   
  156.     defining or editing a custom view in the Custom View Settings dialog   
  157.     box, this message occurs if you choose to include the view on the   
  158.     menu and there are already ten custom-defined views on the menu.  
  159.   
  160. The related information for this account has changed. Do you wish to update   
  161. the account information?  
  162.     You have added/changed the related information for the account   
  163.     selected in the Account ID field: First Name, Last Name, Phone,   
  164.     Department, or Network Address fields. To update the account   
  165.     information, choose the Yes button.  To save the modified information   
  166.     with that ticket only, choose the No button. To return to the   
  167.     Ticket window, choose the Cancel button.  
  168.   
  169. The Staff Initials has already been used.  Please provide different initials.  
  170.     When adding or editing the staff profile in the Setup Staff dialog   
  171.     box, the initials must be unique.  
  172.   
  173. The View Name has already been used.  Please provide a different name.  
  174.     When defining or editing a custom view in the Custom View Settings   
  175.     dialog box, the view name must be unique.  
  176.   
  177. There are no archived tickets in the file specified. Please select a file   
  178. that contains archived tickets.  
  179.     When restoring tickets from a file, the file specified does not have   
  180.     archived tickets.  The restoration process cannot continue.  
  181.   
  182. This item has already been defined in the database.  
  183.     When adding or editing an item through the Qualification Lists dialog   
  184.     box, the name must be unique within each list.  
  185.   
  186. This ticket is currently being edited by another user. Please make your   
  187. changes later.  
  188.     To support multiple users, LSC locks the ticket (window) last opened   
  189.     by each user.  This ensures that only one person can save changes to   
  190.     a ticket at any time.  When users attempt to edit the same ticket   
  191.     simultaneously, only the changes made by the "first" user (the user   
  192.     who locks the ticket) will be effective.  All other users will be   
  193.     alerted with a message to edit the ticket later.  
  194.   
  195. This will save the detail information for this account.  Do you wish to   
  196. continue?  
  197.     This message enables you to confirm whether you wish to save   
  198.     modifications made to a company's contact detail information (the   
  199.     address, Email, fax, etc.).  There can only be one company ID   
  200.     associated with an account ID.  
  201.   
  202. Warning: The corresponding .ACT file cannot be opened. Do you wish to   
  203. continue?  
  204.     When restoring tickets from a file, LSC cannot open the corresponding   
  205.     .ACT file, or the file does not exist in the same directory as the   
  206.     .ARC file (the main archive file). The .ACT file contains the ticket   
  207.     actions.  
  208.   
  209. Warning: The corresponding .DES file cannot be opened. Do you wish to   
  210. continue?  
  211.     When restoring tickets, LSC cannot open the corresponding .DES file,   
  212.     or the file does not exist in the same directory as the .ARC file   
  213.     (the main archive file). The .DES file contains the ticket problem   
  214.     descriptions.  
  215.   
  216. Warning: The corresponding .DEA file cannot be opened. Do you wish to   
  217. continue?  
  218.     When restoring tickets, LSC cannot open the corresponding .DEA file,   
  219.     or the file does not exist in the same directory as the .ARC file   
  220.     (the main archive file). The .DEA file contains the action   
  221.     descriptions.  
  222.   
  223. Warning: The file specified does not have archived tickets.  Overwrite file   
  224. contents?  
  225.     When you choose to archive tickets to a file, the file selected has   
  226.     a format that is different from the LSC database. Responding Yes to   
  227.     the message will overwrite the file's existing content with LSC   
  228.     database information.    
  229.   
  230. You do not have the rights to add new item in the highlighted field. Please   
  231. select an existing value or see your administrator for granting the proper   
  232. rights.  
  233.     The LSC administrator has set up your security profile (through Setup   
  234.     Staff) such that you may only select existing items from the   
  235.     Qualification Lists (e.g.  Problem Type, Product Category, Issue   
  236.     Type, etc.). In addition, if you are not granted the right to "Setup   
  237.     Staff",  you will not be allowed to add new values in the "Assigned   
  238.     to" and "Person" fields in the Ticket and Add/Edit Action windows   
  239.     respectively.  See your LSC administrator to modify your rights.  
  240.   
  241. You have too many tickets in the database to perform filter/sort operation   
  242. completely.  Please archive old or unwanted tickets.  
  243.     This message displays when there is a large number of tickets in   
  244.     your database and you attempt to perform a filter/sort operation. It   
  245.     is recommended that a maximum of 20,000 tickets be maintained in any   
  246.     ticket database.  
  247.   
  248. You may not delete this staff as he/she is logged in to LSC.  
  249.     As a security measure, you may not delete a staff member in the Setup   
  250.     Staff dialog box when he/she is logged in to LSC.  
  251.   
  252. You may not login to LSC with the same staff initials more than once.  
  253.     As a security measure, you may login to LSC using the same initials   
  254.     on only one station.  
  255.   
  256. You may only delete the activities with the TO_DO action code.  
  257.     Your rights to delete activities are limited to only those that have   
  258.     the "TO_DO" action code.  To delete any other activities, your staff   
  259.     profile needs to be updated in the Setup Staff dialog box.  
  260.   
  261. You may only edit the tickets that are assigned to you.  
  262.     Your rights to edit tickets are limited to those tickets assigned to   
  263.     you only.  To edit all other tickets, your staff profile needs to be   
  264.     updated in the Setup Staff dialog box.  
  265.   
  266. You must enter a Query name.  
  267.     When adding or editing a query, the Query Name must be supplied.  
  268.   
  269. You cannot delete a pre-defined report.  
  270.     There are pre-defined reports that are shipped with LSC which print   
  271.     ticket information in a easy-to-read format. These reports are   
  272.     protected from being deleted accidentally.  
  273.   
  274. You cannot rename a pre-defined report.  
  275.     There are pre-defined reports that are shipped with LSC which print   
  276.     ticket information in a easy-to-read format. These reports are   
  277.     protected from being renamed accidentally.  
  278.   
  279.   
  280.   
  281. 13.0  Btrieve Status Codes  
  282.   
  283. This appendix lists the return status codes for Novell's Btrieve Record   
  284. Manager.  
  285.   
  286.   
  287. 13.1 Btrieve Status Codes  
  288.   
  289. Btrieve returns a status code after each operation an application performs.    
  290. If the operation was successful, Btrieve returns status code 0.  If the   
  291. operation was not successful, Btrieve will return one of the nonzero status   
  292. codes described in this section.  
  293.   
  294. If Btrieve returns a code that is not contained in this section, refer to   
  295. your Btrieve Installation and Operation Manual for error codes from the   
  296. utilities.  
  297.   
  298. 01  INVALID OPERATION  
  299.     The operation parameter specified in the call is invalid.  
  300.   
  301. 02  I/O ERROR  
  302.     An error occurred during disk read/write.  This status code   
  303.     indicates that the file has been damaged and must be recreated, or   
  304.     that the file specified on the open call was not created.  This   
  305.     status code also occurs if the application passed an invalid   
  306.     position block.  
  307.   
  308. 03  FILE NOT OPEN  
  309.     The operation cannot execute because the file is not open.  A   
  310.     successful Open operation must be performed before Btrieve can   
  311.     process any other operations.  This status code may also occur if   
  312.     the application passed an invalid position block for the file.  
  313.   
  314. 04  KEY VALUE NOT FOUND  
  315.     The specified key value in the index path was not found.  
  316.   
  317. 05  DUPLICATE KEY VALUE  
  318.     A record with a key field containing a duplicate key value cannot   
  319.     be added to an index that does not allow duplicate values.  
  320.   
  321. 06  INVALID KEY NUMBER  
  322.     The value stored in the key number parameter was not valid for the   
  323.     file being accessed.  The key number must correspond to one of the   
  324.     keys defined when the file was created or to a supplemental index.  
  325.   
  326. 07  DIFFERENT KEY NUMBER  
  327.     The key number parameter changed before a Get Next, Get Next   
  328.     Extended, Get Previous, Get Previous Extended, Update, or Delete   
  329.     operation.  The operation specified requires the same key number   
  330.     parameter as the previous operation because Btrieve uses positioning   
  331.     information relative to the previous key number.  
  332.   
  333.     If you need to change key numbers between consecutive Get Next, Get   
  334.     Next Extended, Get Previous, or Get Previous Extended operations,   
  335.     use a Get Position operation followed by a Get Direct operation to   
  336.     re-establish positioning for the new index path.  
  337.   
  338. 08  INVALID POSITIONING  
  339.     The current position must be established to update or delete a   
  340.     record.  Perform a Get or Step operation to establish the current   
  341.     position.  This status code may also occur if the application   
  342.     passed an invalid position block for the file.  
  343.   
  344. 09  END-OF-FILE  
  345.     The operation tried to read past the file boundaries (end-of-file or   
  346.     start-of-file).  When reading a file in ascending order according to   
  347.     an index path, Btrieve returns the last record in that index path.    
  348.     When reading a file in descending order according to an index path,   
  349.     Btrieve returns the first record in the index path.  
  350.   
  351.     The Get Extended and Step Extended operations return this status   
  352.     code if the number of records satisfying the filtering condition is   
  353.     less than the number of specified records to be returned and the   
  354.     reject count has not been reached.  
  355.   
  356. 10  MODIFIABLE KEY VALUE ERROR  
  357.     The operation tried to modify a key field which is defined as   
  358.     non-modifiable.  
  359.   
  360. 11  INVALID FILENAME  
  361.     The filename specified does not conform to file naming conventions.  
  362.   
  363. 12  FILE NOT FOUND  
  364.     The filename specified does not exist.  Check the key buffer   
  365.     parameter to make sure the pathname is terminated with a blank or   
  366.     a binary zero.  
  367.   
  368. 13  EXTENDED FILE ERROR  
  369.     Btrieve could not find the extension file for an extended file   
  370.     which the application tried to open.  Extension files must be   
  371.     loaded on the logical disk drive specified when the extension was   
  372.     created.  Both the primary file and its extension file must be   
  373.     on-line to access an extended file.  
  374.   
  375. 14  PRE-IMAGE OPEN ERROR  
  376.     The pre-image file could not be created or opened.  There are three   
  377.     possible causes for this error.  
  378.         - Btrieve could not create a new pre-image file because your   
  379.         disk directory is full.  Btrieve must be able to create a   
  380.         pre-image file.  
  381.         - Btrieve could not open the pre-image file to restore file   
  382.         integrity.  If the pre-image file was erased or damaged,   
  383.         Btrieve cannot restore the file's integrity.  In this case,   
  384.         either use the RECOVER command in the BUTIL utility to   
  385.         retrieve the damaged file's data records in a sequential   
  386.         file, or replace the file with its most recent backup.  
  387.         - Btrieve could not assign a handle to the pre-image file   
  388.         because the Btrieve was not started by a user with access   
  389.         rights to the pre-image file.  
  390.   
  391. 15  PRE-IMAGE I/O ERROR  
  392.     An I/O error occurred during the pre-imaging function.  Either the   
  393.     disk is full or the pre-image file is damaged.  
  394.         - If the disk is full, erase any unnecessary files or   
  395.         extend the file to gain additional disk space.  
  396.         - If the pre-image file is damaged, the integrity of   
  397.         the Btrieve file cannot be ensured.  Either use the   
  398.         RECOVER command in the BUTIL utility to retrieve the   
  399.         damaged file's data records in a sequential file, or   
  400.         replace the file with its most recent backup.  
  401.   
  402. 16  EXPANSION ERROR  
  403.     An error occurred while writing the directory structure to disk   
  404.     prior to the creation of the expanded file partition.  Either   
  405.     Btrieve could not close the file, or a new page was added to the   
  406.     file and Btrieve could not close and reopen the file to update the   
  407.     directory structure.  Check for a disk hardware failure.  
  408.   
  409. 17  CLOSE ERROR  
  410.     An error occurred while writing the directory structure to disk   
  411.     prior to closing the file.  Either Btrieve could not close the file,   
  412.     or a new page was added to the file and Btrieve could not close and   
  413.     reopen the file to update the directory structure.  Check for a   
  414.     disk hardware failure.  This status code also occurs if the   
  415.     application passed an invalid position block for the file.  
  416.   
  417. 18  DISK FULL  
  418.     The disk is full and the file could not be expanded to accommodate   
  419.     the insertion.  Either erase any unnecessary files or extend the   
  420.     file to gain additional disk space.  
  421.   
  422. 19  UNRECOVERABLE ERROR  
  423.     An unrecoverable error has occurred.  File integrity cannot be   
  424.     ensured.  Either use the RECOVER command in the BUTIL utility to   
  425.     retrieve the damaged file's data records in a sequential file, or   
  426.     replace the Btrieve with its most recent backup.  
  427.   
  428. 20  RECORD MANAGER INACTIVE  
  429.     A request has been made before the Record Manager has been started.    
  430.     Restart the Record Manager.  
  431.       
  432.     In network environments, the operation was not processed because   
  433.     BREQUEST was not loaded.  Reload BREQUEST.  
  434.   
  435. 21  KEY BUFFER TOO SHORT  
  436.     The key buffer parameter was not long enough to accommodate the   
  437.     key field for the index path requested.  Verify that the length of   
  438.     the key buffer equals the defined length of the key specified in   
  439.     the key number parameter.  This status code can be returned only by   
  440.     certain interfaces.  
  441.   
  442. 22  DATA BUFFER LENGTH  
  443.     The data buffer parameter was not long enough to accommodate the   
  444.     length of the data record defined when the file was created.  Verify   
  445.     that the length of the data buffer is at least as long as the   
  446.     file's defined record length.  
  447.         - For Get or Step operations, if the data buffer is too   
  448.         short to contain the fixed length portion of the record,   
  449.         Btrieve does not return any data to the data buffer.  If   
  450.         the record is a variable length record and the data buffer   
  451.         is too short to contain the entire variable length portion   
  452.         of the record, Btrieve returns as much data as it can and a   
  453.         status code 22, indicating that it could not return the   
  454.         entire record.  
  455.         - For the Insert operation, Btrieve does not insert the   
  456.         record if the data buffer is shorter than the fixed   
  457.         length portion of the record.  
  458.         - For the Update operation, if the data buffer is too   
  459.         short to contain the fixed length portion of any record,   
  460.         Btrieve does not update the record.  
  461.         - For the Create, Stat, and Create Supplemental Index   
  462.         operations, a status code 22 indicates that the data   
  463.         buffer is not long enough to contain all the file and   
  464.         key specifications, and the alternate collating sequence   
  465.         definition, if specified.  
  466.   
  467. 23  POSITION BLOCK LENGTH  
  468.     The position block parameter was not 128 bytes long.  This error   
  469.     can only be detected using certain language interfaces.  
  470.   
  471. 24  PAGE SIZE ERROR  
  472.     The page size was invalid.  The page size must be a multiple of   
  473.     512 bytes but must be no larger than 4096 bytes.  
  474.   
  475. 25  CREATE I/O ERROR  
  476.     The file specified could not be created.  Possible causes are a   
  477.     full disk directory or a full disk.  If you are creating a file   
  478.     over an existing file, Btrieve returns this status code if the   
  479.     existing file is open or the operating system does not allow the   
  480.     creation for some other reason (for example, a NetWare file is   
  481.     flagged transactional).  
  482.   
  483. 26  NUMBER OF KEYS  
  484.     The number of keys specified for the page size was invalid.    
  485.     For standard Btrieve files with a page size of 512 bytes, the   
  486.     number of key segments must be between 1 and 8.  For larger page   
  487.     sizes, the number of key segments must be between 1 and 24.  You   
  488.     must define at least one key without the null attribute.  
  489.   
  490. 27  INVALID KEY POSITION  
  491.     The key field position specified exceeded the defined record   
  492.     length for the file.  Either the key position was greater than the   
  493.     record length or the key position plus the key length exceeded the   
  494.     record length.  For key-only files, the key must begin in the first   
  495.     byte of the record (position 1).  
  496.   
  497. 28  INVALID RECORD LENGTH  
  498.     The record length was invalid.  The record length specified   
  499.     (plus overhead for duplicates) must be less than or equal to the   
  500.     page size minus 6 or greater than or equal to 4 bytes long.  
  501.   
  502. 29  INVALID KEY LENGTH  
  503.     The key length was invalid.  The key length specified must be   
  504.     greater than zero and cannot exceed 255.  The length of a binary   
  505.     key must be even.  Btrieve requires that each key page in the   
  506.     file is large enough to hold at least eight keys.  
  507.   
  508.     If the page size is too small to accommodate eight occurrences of   
  509.     the specified key length (plus overhead), either increase the   
  510.     file's page size, or decrease the key length.  
  511.   
  512. 30  NOT A BTRIEVE FILE  
  513.     The filename specified is not a valid Btrieve file. Either the   
  514.     file was not created by Btrieve, or it was created by an earlier   
  515.     version of Btrieve.  
  516.   
  517.     Another possibility is that the first page of the file, which   
  518.     contains the File Control Record, is damaged.  
  519.   
  520. 31  FILE ALREADY EXTENDED  
  521.     The file specified has already been extended.  A file can be   
  522.     extended only once.  
  523.   
  524. 32  EXTEND I/O ERROR  
  525.     The file could not be extended.  Possible causes are that the   
  526.     directory is full, the disk is full, or the disk is write protected.  
  527.   
  528. 34  INVALID EXTENSION NAME  
  529.     The filename specified for the extended partition was invalid.  
  530.   
  531. 35  DIRECTORY ERROR  
  532.     An error occurred while changing to the directory that contains   
  533.     the Btrieve file.  Either the drive specified in the Get Directory   
  534.     operation does not exist or the pathname specified in a Set   
  535.     Directory operation was invalid.  
  536.   
  537. 36  TRANSACTION ERROR  
  538.     A Begin Transaction operation could not be performed because no   
  539.     transactions were specified when the Btrieve was initialized.  
  540.   
  541. 37  TRANSACTION IS ACTIVE  
  542.     A Begin Transaction was issued while another transaction was active   
  543.     at that station.  Transactions cannot be nested.  
  544.   
  545. 38  TRANSACTION CONTROL FILE I/O ERROR  
  546.     An error occurred when Btrieve tried to write to the transaction   
  547.     control file.  Possible causes were that the disk was full, the   
  548.     disk was write protected, or the transaction control file (which   
  549.     was created when the Btrieve was loaded) was deleted.  
  550.   
  551. 39  END/ABORT TRANSACTION ERROR  
  552.     An End or Abort Transaction operation was issued without a   
  553.     corresponding Begin Transaction operation.  
  554.   
  555. 40  TRANSACTION MAX FILES  
  556.     The application tried to update more than the maximum number of   
  557.     files allowed within a transaction.  The maximum number of   
  558.     different files that can be updated during a logical transaction   
  559.     is set when Btrieve is configured.  Refer to your Btrieve   
  560.     Installation and Operation manual for more information on   
  561.     configuration.  
  562.   
  563. 41  OPERATION NOT ALLOWED  
  564.     The application tried to perform an operation that is not allowed   
  565.     at this time.  Some operations are not allowed under certain   
  566.     operating conditions.  For example, Btrieve returns this status   
  567.     code if you attempt to perform a Step, Update, or Delete operation   
  568.     on a key-only file or a Get operation on a data only file.  
  569.   
  570.     Also, certain operations are prohibited during transactions because   
  571.     they have too great an effect on the pre-image file or on Btrieve's   
  572.     performance.  These operations include Close, Set or Clear Owner,   
  573.     Extend, Create Supplemental Index, and Drop Supplemental Index.  
  574.   
  575. 42  INCOMPLETE ACCELERATED ACCESS  
  576.     The application tried to open a file that was previously accessed   
  577.     in accelerated mode and never successfully closed.  The file's   
  578.     integrity cannot be ensured.  Either use the RECOVER command in   
  579.     the BUTIL utility to build a new file or restore the file using   
  580.     the latest backup.  
  581.   
  582. 43  INVALID RECORD ADDRESS  
  583.     The record address specified for a Get Direct operation was invalid.    
  584.     The address is outside of the file's boundaries; it is not on a   
  585.     record boundary within a data page, or on a data page.  The 4-byte   
  586.     address you specify for a Get Direct operation should be one that   
  587.     was obtained by a Get Position operation.  
  588.   
  589. 44  NULL KEY PATH  
  590.     The application tried to use the Get Direct operation to establish   
  591.     an index path for a key whose value is null in the corresponding   
  592.     record.  Btrieve cannot establish positioning based on a null key   
  593.     value.  
  594.   
  595. 45  INCONSISTENT KEY FLAGS  
  596.     The key flags specification on a Create operation was inconsistent.    
  597.     If a key has multiple segments, the duplicate, modifiable, and   
  598.     null attributes should be the same for each segment in the key.  
  599.   
  600. 46  ACCESS TO FILE DENIED  
  601.     The application opened a file in read-only mode and tried to   
  602.     perform an Update, Delete, or Insert on that file.  Another   
  603.     possible cause is that the owner name required for updates was   
  604.     not specified correctly when you opened the file.  
  605.   
  606. 47  MAXIMUM OPEN FILES  
  607.     The number of files opened in accelerated mode exceeded the number   
  608.     of buffers available in Btrieve's cache.  When a file is opened in   
  609.     accelerated mode, Btrieve reserves one of its cache buffers for the   
  610.     file.  Btrieve always reserves five empty buffers for index   
  611.     manipulation.  Reconfigure the Btrieve Record Manager with a   
  612.     smaller page size parameter to allocate more buffers.  
  613.   
  614. 48  INVALID ALTERNATE SEQUENCE DEFINITION  
  615.     The first byte of an alternate collating sequence definition   
  616.     (the identification byte) did not contain the hexadecimal value AC.  
  617.   
  618. 49  KEY TYPE ERROR  
  619.     The application tried to create a file or a supplemental index   
  620.     with an invalid extended key type, or tried to assign an alternate   
  621.     collating sequence to a binary key or key segment.  You can only   
  622.     assign an alternate collating sequence to a string, lstring, or   
  623.     zstring key type.  
  624.   
  625.     This status code is also returned if you define a supplemental   
  626.     index requiring an alternate collating sequence, and no alternate   
  627.     collating sequence definition exists either in the file or in the   
  628.     key definition passed in the data buffer.  
  629.   
  630. 50  OWNER ALREADY SET  
  631.     The application tried to perform a Set Owner operation on a file   
  632.     that already has an owner.  Use the Clear Owner operation to   
  633.     remove the previous owner before specifying a new one.  
  634.   
  635. 51  INVALID OWNER  
  636.     There are two possible causes for this status code:  
  637.         - If your application received this status code after   
  638.         a Set Owner operation, the owner names specified in   
  639.         the key buffer and data buffer did not match.  
  640.         - If your application received this status code after   
  641.         an Open operation, the file you tried to open has an   
  642.         owner name assigned to it.  Your application must   
  643.         specify the correct owner name in the data buffer.  
  644.           
  645. 52  ERROR WRITING CACHE  
  646.     While trying to make a cache buffer available, Btrieve tried to   
  647.     write data to a logical disk drive from a file that was previously   
  648.     opened in accelerated mode.  An I/O error occurred during a write.  
  649.   
  650. 53  INVALID INTERFACE  
  651.     An application tried to access a file containing variable length   
  652.     records with a language interface from Btrieve v3.15 or earlier.    
  653.     To access files with variable length records, you must use v4.xx or   
  654.     later interface.  
  655.   
  656. 54  VARIABLE PAGE ERROR  
  657.     During a Step Direct operation, Btrieve could not read all or part   
  658.     of the variable length portion of a record.  In this case, Btrieve   
  659.     returns as much data as possible to your application.  This error   
  660.     usually indicates file damage to one or more pages in the file.  
  661.   
  662. 55  AUTOINCREMENT ERROR  
  663.     The application tried to specify either the segmented or duplicate   
  664.     attribute for an autoincrement key type.  An autoincrement key   
  665.     cannot be part of another key and cannot allow duplicates.  
  666.   
  667. 56  INCOMPLETE INDEX  
  668.     A supplemental index was damaged.  This can occur if a Create   
  669.     Supplemental Index operation or a Drop Supplemental Index   
  670.     operation is interrupted and does not run to completion.  Perform   
  671.     a Drop Supplemental Index operation to completely remove the index   
  672.     from the file.  
  673.   
  674. 57  EXPANDED MEMORY ERROR  
  675.     This error is applicable only in the client-based DOS environment.    
  676.     Btrieve returns this status if it receives an error from the   
  677.     Expanded Memory Manager.  This error usually means that Btrieve   
  678.     was unable to save or restore the memory mapping register context,   
  679.     indicating an incompatibility with another application that uses   
  680.     expanded memory.  
  681.   
  682. 58  COMPRESSION BUFFER TOO SHORT  
  683.     The application tried to read or write a record that is longer   
  684.     than the value specified for the size of the compression buffer.    
  685.     Reconfigure the Btrieve Record Manager, specifying a higher value   
  686.     for the "Maximum Compressed Record Size" option.  
  687.   
  688. 59  FILE ALREADY EXISTS  
  689.     This status code is returned for the Create operation if you   
  690.     specified -1 in the key number parameter and the name of an   
  691.     existing file in the key buffer parameter.  
  692.   
  693. 60  REJECT COUNT REACHED  
  694.     Btrieve rejected the number of records specified by the reject   
  695.     count before an Extended Get/Step operation found the requested   
  696.     number of records which satisfy the filtering condition.  Check   
  697.     the first two bytes of the data buffer returned for the number of   
  698.     records that were retrieved.  
  699.   
  700. 61  WORK SPACE TOO SMALL  
  701.     The Extended Get/Step operations use the pre-image buffer as   
  702.     work space.  This error code indicates that the work space was   
  703.     not large enough to hold the filtering data buffer structure and   
  704.     the largest record to be received.  The size of the work space is   
  705.     configurable (see the Btrieve Installation and Operation manual for   
  706.     more information).  Check the first two bytes of the data buffer   
  707.     returned for the number of records that were retrieved.  
  708.   
  709. 62  INCORRECT DESCRIPTOR  
  710.     The descriptor (data buffer structure), which is passed for an   
  711.     extended Get or Step operation, is incorrect.  
  712.   
  713. 63  INVALID EXTENDED INSERT BUFFER  
  714.     Extended Insert provides an invalid buffer.  Either the buffer   
  715.     length is less than five bytes, or the number of records specified   
  716.     is zero.  
  717.   
  718. 64  FILTER LIMIT REACHED  
  719.     During an Extended Get Next/Previous operation, a rejected record   
  720.     was reached.  Furthermore, this rejected record is such that no   
  721.     other record can satisfy the given filtering condition, going in   
  722.     the direction specified by the operation.  This is applicable only   
  723.     if the key specified by the key number is also used as the filtering   
  724.     field.  
  725.   
  726. 65  INCORRECT FIELD OFFSET  
  727.     The field offset in the extractor of an Extended Get/Step is invalid   
  728.     based on the length of the retrieved record.  
  729.   
  730. 74  AUTOMATIC TRANSACTION ABORT  
  731.     This is an informative status code and is applicable only in the   
  732.     server-based environment.  Btrieve replaced an End Transaction   
  733.     operation with an Abort Transaction because an error had been   
  734.     detected for a TTS file inside the transaction.  In addition,   
  735.     Btrieve executed the Abort Transaction operation.  
  736.   
  737. 78  DEADLOCK DETECTED  
  738.     Btrieve detected a deadlock condition.  The application should   
  739.     clear all resources (such as aborting or ending the transaction or   
  740.     releasing all record locks) before proceeding.  This allows the other   
  741.     applications to access the resources for which they are waiting.  
  742.   
  743. 80  CONFLICT  
  744.     The Update or Delete operation could not be performed because the   
  745.     record was changed by another application since your application   
  746.     read the record.  Reread the record prior to resending an Update or   
  747.     Delete operation.  
  748.   
  749. 81  LOCK ERROR  
  750.     This error can result from one of two conditions:  
  751.         -  The Btrieve lock table was full.  Decrease the number   
  752.         of locks that your application uses or reconfigure the   
  753.         Btrieve Record Manager and specify a higher value for the   
  754.         "Maximum Number of Record Locks" option.  
  755.         -  The application tried to unlock one record that was   
  756.         locked with a multiple record lock, and the record position   
  757.         stored in the data buffer did not correspond with any   
  758.         record that was locked in that file.  
  759.   
  760. 82  LOST POSITION  
  761.     When performing a Get Next or Get Previous on a key with duplicates,   
  762.     the application tried to retrieve a record that was deleted or   
  763.     whose key value was modified by another application.  Re-establish   
  764.     positioning using a Get Equal or a Get Direct operation.  
  765.   
  766. 83  READ OUTSIDE TRANSACTION  
  767.     The application tried to delete or update a record within a   
  768.     transaction, but the record was not read within the transaction.    
  769.     If you are going to update or delete a record within a transaction,   
  770.     you must read the record within the transaction to ensure you have   
  771.     first obtained exclusive access to the data.  
  772.   
  773. 84  RECORD LOCKED  
  774.     The application tried to apply a nowait lock on a record that was   
  775.     currently locked by another application, or to apply a nowait lock   
  776.     on a file while another application held active record lock(s) in   
  777.     that file.  
  778.   
  779.     If this status code is returned, your application can use either   
  780.     of the following two methods:  
  781.         - Retry the operation until it is successful.  Under light   
  782.         to moderate network use, this may be the simplest and   
  783.         quickest solution.  
  784.         - Use the wait option (+100/+300) instead of the nowait   
  785.         option.  
  786.   
  787. 85  FILE LOCKED  
  788.     The application tried to apply a nowait record or file lock while   
  789.     another application held the file locked.  This status code is   
  790.     also returned when the application tries to open a file outside of   
  791.     a transaction and the file is locked by some other application.  
  792.   
  793.     If this status code is returned, your application can use either   
  794.     of the following two methods:  
  795.         - Retry the operation until it is successful.  Under   
  796.         light to moderate network use, this may be the simplest   
  797.         and quickest solution.  
  798.         - Use the wait option (+100/+300) instead of the nowait   
  799.         option.  
  800.   
  801. 86  FILE TABLE FULL  
  802.     Btrieve's file table was full.  Reconfigure Btrieve and specify a   
  803.     higher value for the "Maximum Number of Open Files" option.  
  804.   
  805. 87  HANDLE TABLE FULL  
  806.     This status code is applicable only in the server-based and Windows   
  807.     environments.  
  808.     Btrieve's handle table was full.  Reconfigure the Btrieve and   
  809.     specify a higher value for the "Maximum Number of File Handles"   
  810.     option.  
  811.   
  812. 88  INCOMPATIBLE MODE ERROR  
  813.     The application tried to open a file in an incompatible mode.  If   
  814.     the first application to access a file opens it in accelerated mode,   
  815.     all other applications must open it in accelerated mode.  If the   
  816.     first application to access a file opens it in non-accelerated mode,   
  817.     other applications cannot open the file in accelerated mode.  
  818.   
  819. 90  REDIRECTED DEVICE TABLE FULL  
  820.     This status code is applicable only in the server-based environment.   
  821.     BREQUEST's redirection table or server routing table was full.    
  822.     This occurs if you attach to additional servers or map to additional   
  823.     drives after you loaded BREQUEST.  Reload BREQUEST, specifying a   
  824.     larger number for the "Number of File Servers" or "Number of   
  825.     Mapped Drives" options (/S and /R respectively).  
  826.   
  827.     This error also occurs if you detach a particular server and attach   
  828.     to a different server.  Once a workstation has attached to a server,   
  829.     BREQUEST will not remove its name from the server routing table.  
  830.   
  831. 91  SERVER ERROR  
  832.     This status code is applicable only in the server-based environment.  
  833.     BREQUEST could not establish a session with the server.  In NetWare   
  834.     environments, either the NetWare Btrieve Record Manager has not   
  835.     been started or the server was not active.  Verify that the   
  836.     NetWare Btrieve Record Manager is active on the server in question.  
  837.   
  838. 92  TRANSACTION TABLE FULL  
  839.     This status code is applicable only in the server-based environment.  
  840.     The maximum number of active transactions was exceeded.  Reconfigure   
  841.     Btrieve and specify a higher value for the "Number of Concurrent   
  842.     Transactions" option.  
  843.   
  844. 93  INCOMPATIBLE LOCK TYPE  
  845.     Your application tried to mix single record locks (+100/+200) and   
  846.     multiple record locks (+300/+400) in the same file at the same time.   
  847.     All locks of one type must be released before a lock of the other   
  848.     type can be executed.  
  849.   
  850. 94  PERMISSION ERROR  
  851.     Your application tried to open or create a file in a directory   
  852.     without the proper privileges.  Btrieve does not override the   
  853.     network privileges assigned to users.  
  854.   
  855. 95  SESSION NO LONGER VALID  
  856.     This status code is applicable only in the server-based environment.  
  857.     The previously established session was no longer active due to an   
  858.     error at the workstation, the file server, or on the network.    
  859.     Verify that your workstation is still attached to the file server   
  860.     and then reload BREQUEST.  
  861.   
  862. 96  COMMUNICATIONS ENVIRONMENT ERROR  
  863.     This status code is applicable only in the server-based environment.  
  864.     This code occurs when loading Btrieve on a NetWare server.  The SPX   
  865.     connection table is full.  Reload SPX, specifying a higher value   
  866.     for the connection table.  Refer to the NetWare system documentation   
  867.     for more information.  
  868.   
  869. 97  DATA MESSAGE TOO SMALL  
  870.     This status code is applicable only in the server-based environment.  
  871.     Your application tried to read or write a record which was longer   
  872.     than the Btrieve Record Manager or BREQUEST could handle.    
  873.     Reconfigure the Btrieve Record Manager and specify a higher value   
  874.     for the "Maximum Record Length" option.  Reload BREQUEST and   
  875.     specify a higher value for the /D option.  
  876.   
  877.         - For an Update, Insert, or Create operation, the application   
  878.         receives this error if the data buffer length it specifies   
  879.         for the record exceeds the length specified for the Btrieve   
  880.         Record Manager or BSERVER.  
  881.         - For a Get, Step, or Stat operation, the application   
  882.         receives this error if the value specified for the data   
  883.         buffer length is shorter than the length of the data Btrieve   
  884.         would return, regardless of the data buffer length specified   
  885.         in the program.  
  886.   
  887. 98  INTERNAL TRANSACTION ERROR  
  888.     This status code is applicable only in the server-based environment.  
  889.     An error has been detected while executing a previous operation on   
  890.     a NetWare TTS file.  Therefore, no operation other than Abort   
  891.     Transaction (21) is allowed at this point.  
  892.   
  893. 99  THE REQUESTER CANNOT ACCESS THE NETWARE RUNTIME SERVER  
  894.     The DOS Requester returns this status code when NetWare Runtime   
  895.     server support is enabled (/C:1) and the Requester either detects   
  896.     no existing connection or cannot find a valid login username.    
  897.     If the Requester cannot find a login username other than   
  898.     SUPERVISOR, there is no valid name to pass.  
  899.   
  900. 100  NO CACHE BUFFERS ARE AVAILABLE  
  901.     Btrieve has used all the cache buffers it allocated at load time.    
  902.     Using the Setup utility, you can increase the value for the Cache   
  903.     Allocation configuration option.  Alternatively, you can change the   
  904.     Number of Remote Sessions configuration option to decrease the   
  905.     number of concurrent Btrieve users.  For more information, refer   
  906.     to Chapter 3, "Installing and Configuring Btrieve," in the   
  907.     Btrieve Installation and Operation manual.  
  908.   
  909. 101  INSUFFICIENT OPERATING SYSTEM MEMORY IS AVAILABLE  
  910.     There is not enough operating system memory available to perform   
  911.     the requested operation.  Decrease the value for the Cache   
  912.     Allocation configuration option (using the Setup utility),   
  913.     decrease the number of concurrent Btrieve users (using the Number   
  914.     of Remote Sessions configuration option in the Setup utility), or   
  915.     add memory to the server.  For more information on the configuration   
  916.     options, refer to Chapter 3, "Installing and Configuring Btrieve,"   
  917.     in the Btrieve Installation and Operation manual.  
  918.   
  919. 102  INSUFFICIENT STACK SPACE IS AVAILABLE  
  920.     Btrieve has run out of stack space.  To increase the amount of   
  921.     stack space available to your application, relink the application,   
  922.     setting the stack size to a higher value.  Only the NLM   
  923.     applications calling Btrieve on the local server get this message.  
  924.   
  925. 103  THE CHUNK OFFSET IS TOO BIG  
  926.     A Get Direct/Chunk operation has specified an offset beyond the   
  927.     end of the record, either explicitly or through the use of the   
  928.     next-in-record bias to the subfunction value.  Unless Btrieve   
  929.     returns this status while processing the first chunk, the   
  930.     operation was partially successful.  Check the data buffer length   
  931.     parameter immediately after the call to see how much data   
  932.     (and therefore how many chunks) Btrieve retrieved.  
  933.   
  934.     This code can also be returned by the Update Chunk operation   
  935.     when the specified offset is more than one byte beyond the end of   
  936.     the record.  However, in this situation, Status Code 103   
  937.     indicates that Btrieve made no changes to the record.  
  938.   
  939. 104  THE LOCALE INFORMATION COULD NOT BE FOUND  
  940.     The Create or Create Index function returns this status code to   
  941.     indicate that the operating system was not able to return a   
  942.     collation table for the country ID and code page specified.    
  943.     Check that the application specified the locale's country ID and   
  944.     code page correctly and that the operating system is configured to   
  945.     support the country ID and code page.  
  946.   
  947. 105  THE FILE CANNOT BE CREATED WITH VARIABLE-TAIL ALLOCATION TABLES (VATS)  
  948.     The application specified that a Btrieve file should be created   
  949.     with Variable-tail Allocation Tables (VATs); however, the   
  950.     application failed to specify that the file was to use   
  951.     variable-length records (a precondition for files to use VATs).    
  952.     This status applies to key-only files as well as regular data files.  
  953.   
  954. 106  THE OPERATION CANNOT GET THE NEXT CHUNK  
  955.     The application called the Get Direct/Chunk operation to retrieve   
  956.     a chunk from a record and used the next-in-record bias on the   
  957.     descriptor subfunction.  However, after the application   
  958.     established its positioning in the record (but prior to this call),   
  959.     the target record was deleted.  
  960.   
  961. 107  CHUNK UPDATES/RETRIEVALS CANNOT BE PERFORMED ON THE FILE  
  962.     The application tried to use either a Get Direct/Chunk operation   
  963.     or an Update Chunk operation on a pre-v6.0 formatted file.  
  964.   
  965.   
  966. 13.2 Client-Based Btrieve for OS/2 and Windows Status Codes  
  967.   
  968. Client-based Btrieve may return the following status codes in an OS/2 or   
  969. Windows environment.  
  970.   
  971. 1001  THE MULTIPLE LOCKS OPTION IS OUT OF RANGE  
  972.     The number specified for the Multiple Locks configuration option   
  973.     must be between 1 and 255, inclusive.  
  974.   
  975. 1002  BTRIEVE CANNOT ALLOCATE THE MEMORY NEEDED  
  976.     Make sure that the workstation has enough memory to load all the   
  977.     programs it requires.  
  978.   
  979. 1003  THE MEMORY SIZE IS TOO SMALL  
  980.     Make sure the value for the Memory Size configuration option is   
  981.     large enough to accommodate the required cache size.  
  982.   
  983. 1004  THE PAGE SIZE OPTION IS OUT OF RANGE  
  984.     The value of the Page Size configuration option must be an even   
  985.     multiple of 512, and it must be between 512 and 4,096, inclusive.  
  986.   
  987. 1005  THE PRE-IMAGE FILE DRIVE OPTION IS INVALID  
  988.     You must specify a valid drive letter for the Pre-Image File Drive   
  989.     configuration option.  
  990.   
  991.     Note: Pre-image files are used only for files created by Btrieve   
  992.     versions earlier than v6.x, or by v6.x if it was loaded with the   
  993.     Create Btrieve Files in Pre v6.x Format configuration option set to   
  994.     Yes.  
  995.   
  996. 1006  THE PRE-IMAGE BUFFER SIZE OPTION IS OUT OF RANGE  
  997.     The Pre-Image Buffer Size configuration option must be between   
  998.     1 and 64, inclusive.  
  999.   
  1000.     Note: Pre-image files are used only for files created by Btrieve   
  1001.     versions earlier than v6.x, or by v6.x if it was loaded with the   
  1002.     Create Btrieve Files in Pre v6.x Format configuration option set   
  1003.     to Yes.  
  1004.   
  1005. 1007  THE OPEN FILES OPTION IS OUT OF RANGE  
  1006.     The Open Files configuration option must be between 1 and 255,   
  1007.     inclusive.  
  1008.   
  1009. 1008  THE CONFIGURATION OPTIONS ARE INVALID  
  1010.     The configuration options specified contain invalid or   
  1011.     unidentifiable values.  For more information on configuration   
  1012.     options, refer to the installation and operation manual for   
  1013.     your operating environment.  
  1014.   
  1015. 1009  THE TRANSACTION FILENAME OPTION IS INVALID  
  1016.     The filename specified for the Transaction Filename configuration   
  1017.     option is not valid.  Check to make sure that the transaction   
  1018.     filename is correct.  
  1019.   
  1020. 1011  THE COMPRESSION BUFFER SIZE SPECIFIED IS OUT OF RANGE  
  1021.     The Compression Buffer Size configuration option must be between   
  1022.     1 and 64, inclusive.  
  1023.   
  1024. 1013  THE TASK TABLE IS FULL (WINDOWS ONLY)  
  1025.     The Btrieve DLL may return this status code if the task entry   
  1026.     table is full.  You can remedy this situation by increasing the   
  1027.     number of available task entries; use the tasks initialization   
  1028.     option (tasks=xxx) under the [BTRIEVE] or [BREQUESTDPMI] headings   
  1029.     in NOVDB.INI.  The minimum value for this option is 1; the maximum   
  1030.     value is 255.  
  1031.   
  1032. 1014  THE APPLICATION ENCOUNTERED A STOP WARNING  
  1033.     WBTRVSTOP () returns this status code if the application still has   
  1034.     open files or an active transaction.  The application must close   
  1035.     all files and end all transactions before calling WBTRVSTOP ().  
  1036.   
  1037. 1015  A POINTER PARAMETER IS INVALID  
  1038.     One of the pointer parameters passed into Btrieve is invalid.  
  1039.   
  1040. 1016  BTRIEVE IS ALREADY INITIALIZED  
  1041.     The Btrieve DLL may return this status code if an attempt is made   
  1042.     to initialize Btrieve when it is already initialized.  To   
  1043.     reinitialize Btrieve, close all files, end/abort all transactions,   
  1044.     and call WBTRVSTOP () before calling the initialization function.  
  1045.   
  1046. 1017  THE BTRIEVE REQUESTER FOR WINDOWS CANNOT FIND WBTRVRES.DLL  
  1047.     WBTRCALL.DLL returns this status code when it cannot find the   
  1048.     resource file WBTRVRES.DLL.  You can remedy this situation by   
  1049.     placing a copy of the WBTRVRES.DLL file in the same directory as   
  1050.     the WBTRCALL.DLL file.  
  1051.   
  1052.   
  1053. 13.3 Btrieve Requester Status Codes  
  1054.   
  1055. This section lists the status codes that the Btrieve Requesters may generate.  
  1056.   
  1057. 2001  THE MEMORY ALLOCATION IS INSUFFICIENT  
  1058.     In an OS/2 environment, the Requester cannot allocate enough   
  1059.     memory for the parameters specified with the BRQPARMS environment   
  1060.     variable.  In a DOS environment, reduce the value specified for   
  1061.     the /D configuration option.  
  1062.   
  1063. 2002  THE OPTION IS INVALID OR OUT OF RANGE  
  1064.     In an OS/2 environment, either one of the options specified with   
  1065.     the BRQPARMS environment variable is invalid (such as /P instead   
  1066.     of /D) or the value specified for a parameter is out of range.    
  1067.     Check the SET BRQPARMS statements to make sure it is correct.  
  1068.   
  1069. 2003  THE REQUESTER DOES NOT ALLOW LOCAL ACCESS TO THE SPECIFIED FILE  
  1070.     The application attempted to access a file stored on a local drive.    
  1071.     The version of WBTRCALL.DLL installed at the workstation does not   
  1072.     allow access to local files.  
  1073.   
  1074. 2004  SPX IS NOT INSTALLED  
  1075.     Install the NetWare SPX v1.3 or later communications software for   
  1076.     OS/2.  
  1077.   
  1078. 2005  AN INCORRECT VERSION OF SPX IS INSTALLED  
  1079.     Install the NetWare SPX v1.3 or later communications software for   
  1080.     OS/2.  
  1081.   
  1082. 2006  THERE IS NO AVAILABLE SPX CONNECTION  
  1083.     SPX has already established the maximum number of sessions it can   
  1084.     handle.  To increase the maximum, edit the NET.CFG file.  Refer to   
  1085.     your NetWare documentation for more information on NET.CFG.  
  1086.   
  1087. 2007  A POINTER PARAMETER IS INVALID  
  1088.     One of the pointer parameters passed to Btrieve is invalid.  Check   
  1089.     the program to ensure that the pointer parameters are correct.  
  1090.   
  1091.   
  1092.  
  1093. 14.0  LSC File List  
  1094.   
  1095. This appendix contains a list of all the files included with LAN Support   
  1096. Center.  
  1097.   
  1098.    
  1099. 14.1  LSC Main File List  
  1100.   
  1101. FILE NAME       PURPOSE  
  1102. USEBRQ.BAT      The batch file that enables users to run LSC with the server-  
  1103.         based Btrieve  
  1104. USEBTR.BAT      The batch file that enables users to run LSC with the client-  
  1105.         based Btrieve  
  1106. FILE.DDF        Data dictionary file #1 needed to build custom reports.  
  1107. FIELD.DDF       Data dictionary file #2 needed to build custom reports.  
  1108. INDEX.DDF       Data dictionary file #3 needed to build custom reports.  
  1109. CONVERT.DLL     The library that converts LSC 2.x database to 3.0 format.  
  1110. LSC.EXE         The main executable program that runs LSC.  
  1111.   
  1112.   
  1113. 14.2  LSC Ticket Records Databases  
  1114.   
  1115. FILE NAME       PURPOSE  
  1116. HLPDSK1A.DAT    Action header database  
  1117. HLPDSK1H.DAT    Ticket header database  
  1118. HLPDSK1P.DAT    Ticket problem description database  
  1119. HLPDSK1T.DAT    Action description database  
  1120.   
  1121.   
  1122. 14.3  LSC Administrative Databases  
  1123.   
  1124. FILE NAME       PURPOSE  
  1125. HLPDSK1C.DAT    Unique Account IDs with corresponding information database  
  1126. HLPDSK1D.DAT    Department database  
  1127. HLPDSK1F.DAT    Filter criteria database  
  1128. HLPDSK1G.DAT    Product category database  
  1129. HLPDSK1I.DAT    Action code database  
  1130. HLPDSK1L.DAT    Last name database  
  1131. HLPDSK1M.DAT    First name database  
  1132. HLPDSK1N.DAT    Network address database  
  1133. HLPDSK1Q.DAT    Query database  
  1134. HLPDSK1R.DAT    Report database  
  1135. HLPDSK1S.DAT    Staff (Login, security, etc.) database  
  1136. HLPDSK1U.DAT    Issue type database  
  1137. HLPDSK1V.DAT    Report query database  
  1138. HLPDSK1X.DAT    Labeling database  
  1139. HLPDSK1Y.DAT    Problem type database  
  1140. HLPDSK1Z.DAT    Unique Company IDs with corresponding information database  
  1141.   
  1142.   
  1143. 14.4 Pre-defined LSC Reports  
  1144.   
  1145. NOTE: If you have modified the LSC database labels, the report names listed   
  1146. in the Choose Report dialog box will reflect the current labels.  
  1147.   
  1148. FILE NAME       REPORT NAME               
  1149. ALLACCT.RPT     All Tickets by Account ID                 
  1150. CLSDEPT.RPT     Closed Tickets by Department  
  1151. ALLSTAFF.RPT    All Tickets by Assigned To                
  1152. CLSPRIOY.RPT    Closed Tickets by Priority  
  1153. ALLDEPT.RPT     All Tickets by Department                 
  1154. CLSPBTYP.RPT    Closed Tickets by Problem Type  
  1155. ALLDATE.RPT     All Tickets by Date               
  1156. ACTLIST.RPT     Daily Action Listing by Person  
  1157. ALLPRIOY.RPT    All Tickets by Priority           
  1158. MONPBTYP.RPT    Monthly Statistics by Problem Type   
  1159. ALLPBTYP.RPT    All Tickets by Problem Type               
  1160. MONTCKT.RPT     Monthly Ticket Load Statistics by Problem Type  
  1161. AINITSTF.RPT    Average Initial Response Time by Assigned To              
  1162. OPNSTAFF.RPT    Open Tickets by Assigned To  
  1163. AVEINIT.RPT     Average Initial Response Time by Problem Type             
  1164. OPNDATE.RPT     Open Tickets by Date  
  1165. AVESTAFF.RPT    Average Time to Close by Assigned To              
  1166. OPNDEPT.RPT     Open Tickets by Department  
  1167. AVEPBTYP.RPT    Average Time to Close by Problem Type             
  1168. OPNPRIOY.RPT    Open Tickets by Priority  
  1169. CLEDEPT.RPT     Client listing by Department              
  1170. OPNPBTYP.RPT    Open Tickets by Problem Type  
  1171. CLENAME.RPT     Client listing by Last Name, First Name           
  1172. TCKETDET.RPT    Ticket Details   
  1173. CLSSTAFF.RPT    Closed Tickets by Assigned To             
  1174. QUERY.RPT       Last page of all printed reports which lists   
  1175.         the queries applied to the report.  
  1176. CLSDATE.RPT     Closed Tickets by Date                    
  1177.   
  1178.   
  1179. 14.5  LSC Dynamic Link Libraries  
  1180.   
  1181. FILE NAME       PURPOSE  
  1182. BDIABOUT.DLL    McAfee About Box  
  1183. BWLIB.DLL       McAfee License Installation  
  1184. CHK4BRQ.DLL     McAfee Check for Brequest  
  1185. COMMDLG.DLL     Common Dialog Boxes  
  1186. CRPE.DLL        Crystal report engine  
  1187. CTL3D.DLL       Three-D effects to controls  
  1188. NWCALLS.DLL     Netware functions   
  1189. NWUTIL.DLL      McAfee NetWare utilities  
  1190. PDBBTRV.DLL     Crystal's Btrieve DLL  
  1191. PDCTBTRV.DLL    Crystal's Btrieve DLL  
  1192. TBPRO1W.DLL     Toolbox DLL  
  1193. TBPRO2W.DLL     Toolbox DLL  
  1194. TBPRO3W.DLL     Toolbox DLL  
  1195. TBPRO5W.DLL     Toolbox DLL  
  1196. UFLSAMP1.DLL    Crystal Report DLL  
  1197. UFLSAMPT.DLL    Crystal Report DLL  
  1198. WBHANDLE.DLL    McAfee Btrieve Handler  
  1199. WBTRCALL.DLL    Novell Btrieve DLL  
  1200. WBTRVDEF.DLL    Novell Btrieve DLL  
  1201. WBTRVRES.DLL    Novell Btrieve DLL  
  1202.   
  1203.   
  1204. 14.6  Crystal Reports v2.0 Files  
  1205.   
  1206. FILE NAME  
  1207. CR2.BMP   
  1208. CR3.BMP  
  1209. CR4.BMP  
  1210. 00019144.DAT   
  1211. 00028747.DAT   
  1212. BWCC.DLL  
  1213. CRXLATE.DLL  
  1214. DDEML.DLL   
  1215. P3CONV.DLL  
  1216. P3DIB.DLL  
  1217. P3FILE.DLL  
  1218. P3INFO.DLL  
  1219. PXENGWIN.DLL  
  1220. CRW.EXE     
  1221. CRW.HLP   
  1222. CRW.INI  
  1223. CRW.NET  
  1224. BTRLABEL.RPT   
  1225. BTRORDER.RPT  
  1226. LABELS.TXT   
  1227.   
  1228.   
  1229.   
  1230. 15.0  Using BREQUEST  
  1231.   
  1232.   
  1233. This appendix discusses the use and configuration of the server-based   
  1234. Btrieve record manager, BREQUEST.  
  1235.   
  1236. 15.1 Using the Btrieve NLM  
  1237.   
  1238. The Btrieve record manager must be loaded before running the BrightWorks   
  1239. EQUIP program.  It is highly recommended that you use the server-based   
  1240. BREQUEST program while running EQUIP.  This appendix offers recommendations   
  1241. on setting up and using the Btrieve NLM.   
  1242.   
  1243. NOTE:  a - When using BREQUEST, version 6.10 or greater is required.  
  1244. b -  When using BREQUEST, BSPXCOM and BROUTER must also be loaded on the   
  1245. fileserver.  For details on loading these programs, refer to your Novell   
  1246. documentation.  
  1247.   
  1248.   
  1249. 15.1.1 Using the NLM with LSC  
  1250.   
  1251. Using BREQUEST, as opposed to BTRIEVE, will improve the performance of   
  1252. data collection, auditing and reporting by at least 50% and as much as 500%.    
  1253. An additional advantage is the savings in local (client) memory*BTRIEVE.EXE   
  1254. can occupy from 50-85K of conventional memory, whereas BREQUEST.EXE can   
  1255. occupy approximately 31-45K.  The exact amount of memory required for both   
  1256. programs depend on the specified command line parameters.  
  1257.   
  1258. Use the following procedure to configure the Btrieve NLM.  
  1259.   
  1260. 1.  To configure the NLM, run BSETUP.NLM.  
  1261.   
  1262.     At the file server console prompt, type:  
  1263.   
  1264.     LOAD BSETUP <ENTER>  
  1265.   
  1266. 2.  Choose Set Configuration to verify that the following options are defined.  
  1267.   
  1268.     The values provided below are the minimum values required; your   
  1269.     current values may be set higher.  
  1270.   
  1271.     o  Number of Open Files: = 22  (default = 20)  
  1272.     o  Number of Transactions: = 1  (default = 0)  
  1273.     o  Largest Record Size: = 17000  (default = 8192)  
  1274.     o  Largest Page Size: = 4096  (default = 4096)  
  1275.   
  1276. NOTE:  All other BSETUP options can remain unchanged.  
  1277.   
  1278. 3.  Save the configuration, and exit BSETUP.  
  1279.   
  1280.     BSETUP writes the configuration changes to the BSTART.NCF file.  The   
  1281.     changes do not take effect until the next time the Btrieve NLM is loaded.   
  1282.   
  1283. 4.  To load the NLM, run BSTART.  
  1284.   
  1285.     At the file server console prompt, type:  
  1286.   
  1287.     BSTART <ENTER>  
  1288.   
  1289.     BSTART is an NCF file which loads both BTRIEVE.NLM and BSPXCOM.NLM.  
  1290.   
  1291. 5.  To unload the Btrieve NLM, issue the BSTOP command.  
  1292.   
  1293.     If the Btrieve NLM was loaded when changes were made in BSETUP, you   
  1294.     need to unload Btrieve and then reload the NLMs in order for the changes   
  1295.     to take effect.  
  1296.   
  1297.     For example, at the console prompt, type:  
  1298.   
  1299.     BSTOP <ENTER>  
  1300.     BSTART <ENTER>  
  1301.   
  1302.   
  1303.   
  1304. 15.2 Using Brequest in a Login Script  
  1305.   
  1306. To ensure that EQUIP is executed on a regular basis, the EQUIP command can   
  1307. be placed in your system login script.  Because the Btrieve database must be   
  1308. loaded before running EQUIP, a Btrieve command must also be placed in the   
  1309. login script.  EQUIP executes much faster when used in conjunction with   
  1310. Brequest and the BTRIEVE NLM; therefore, the login script should contain   
  1311. the BREQUEST.EXE command.    
  1312.   
  1313. The following example illustrates how EQUIP can be run from the system login   
  1314. script, using BREQUEST.  Comments are indicated in the text between the   
  1315. angle brackets.  
  1316.   
  1317.     MAP F:=FS/SYS:Fusion <maps drive to Fusion dir>  
  1318.     DRIVE F: <changes to the Fusion dir>  
  1319.     #BREQUEST /D:17000  
  1320.     #EQUIP <specify scan parameters>  
  1321.     #ENDBTRV  
  1322.   
  1323. NOTES: a -  Loading SPX -  All BrightWorks modules require SPX to be loaded   
  1324. at each workstation. Brequest communicates with BSPXCOM.NLM via SPX.    
  1325. BSPXCOM, in turn, passes all requests from Brequest to the BTRIEVE NLM.    
  1326. If SPX is not loaded at a workstation, that workstation has no communication   
  1327. whatsoever with the Btrieve record manager. If you have loaded Brequest and   
  1328. are getting "BTRIEVE Record Manager Not Loaded" messages, make sure that   
  1329. SPX is loaded.  This normally only becomes an issue on workstations that   
  1330. load the ODI drivers because the ODI drivers can optionally load SPX.  
  1331. b -  Brequest /D switch - The /D: parameter specifies the size of the "data   
  1332. message buffer length."  This buffer refers to the maximum record size that   
  1333. the NLM will transmit to the workstation.  This switch should be set to   
  1334. 17000 for the purposes of BrightWorks.  
  1335. c -  Brequest /L switch - When running SDUPDATE.EXE in a DOS box, you must   
  1336. load another session of BREQUEST by entering the following command:   
  1337.     BREQUEST /D:17000 /L  
  1338. After running the program, end the additional session by issuing the   
  1339. ENDBTRV command.  
  1340. d -  Brequest Error 87 - If you receive an "Error 87" from Btrieve while   
  1341. using Brequest, increase the 'Number Of Open Files' setting in BSETUP.  
  1342.   
  1343.   
  1344.   
  1345. 15.3 Using the Btrieve VAP   
  1346.   
  1347. All of the options and suggestions regarding the Btrieve NLM also apply to   
  1348. the Btrieve VAP.  The BSETUP parameters, Brequest parameters, and Windows   
  1349. requester initialization settings are identical.  
  1350.   
  1351. NOTE:  When using the Btrieve VAP, the file server needs to be rebooted in   
  1352. order for any changes in BSETUP to take effect.   
  1353.   
  1354.   
  1355.   
  1356. 16.0  LSC Import/Export Utility  
  1357.   
  1358. This appendix discusses the use of the DOS-based LSC import/export utility.  
  1359.   
  1360. 16.1  Using the Import/Export Utility  
  1361.   
  1362. The import/export utility, LSCIMEX.EXE, is a DOS application which allows   
  1363. you to import or export data into/from the LSC 3.0 databases. The   
  1364. import/export utility is copied into the LSC program directory upon   
  1365. installing LSC.    
  1366.   
  1367. The following requirements must be met before running the import/export   
  1368. utility:  
  1369.   
  1370. o  The utility must be executed from within the directory in which the   
  1371. LSC 3.0 software and database files are located.  
  1372. o  The Btrieve record manager must be loaded before running the utility.    
  1373.   
  1374. Because LSC 3.0 has a customizable interface, most data fields are not   
  1375. restricted to a particular format.  The import/export utility will match the   
  1376. field names in LSC even if they have been changed by the administrator. The   
  1377. only fields that have a specified format are date and time fields. All other   
  1378. fields may be of any type or format.  
  1379.   
  1380. Use the following keys to navigate throughout the utility.  
  1381.   
  1382. KEY             ACTION  
  1383. <ESC>           Return to the previous menu. Also used to initiate the export or   
  1384.         import process.  
  1385. <Up/Down Arrow> Highlight the menu option in the direction of the arrow.  
  1386. <Enter>         Choose the highlighted menu option.  
  1387.   
  1388. A mouse can also be used to navigate throughout the utility and choose menu   
  1389. options.  The mouse cursor appears as a small square.  When the small square   
  1390. rests on a desired menu option, click the left mouse button to choose the   
  1391. option.  
  1392.   
  1393. 16.1.1 Importing Data into LSC  
  1394.   
  1395. Tickets are imported from the file ITICKETS.TXT, and actions from   
  1396. IACTIONS.TXT. To import a file, copy it into the LSC directory as one of the   
  1397. appropriate file names.  The file(s) must be in comma delimited ASCII format.    
  1398.   
  1399. NOTE: Quotes around each text field are optional.  If your text fields   
  1400. contain commas, quotes are required to prevent the commas from being   
  1401. interpreted as delimiters.  
  1402.   
  1403. Use the following procedure to import LSC ticket data from an ASCII text file.  
  1404.   
  1405. 1.  Load the Btrieve record manager.  
  1406.   
  1407.     Either server-based or client-based Btrieve can be used with the   
  1408.     import/export utility.  Refer to section 2.10 for a discussion of the   
  1409.     Btrieve options.  
  1410.   
  1411. 2.  Execute the import/export utility.  
  1412.   
  1413.     Enter the following command at the DOS prompt:  
  1414.   
  1415.     LSCIMEX <ENTER>  
  1416.   
  1417.     The main menu displays.  
  1418.   
  1419. 3.  From the main menu, choose the Import Data into LSC option.  
  1420.   
  1421.     The Import Menu displays.  
  1422.   
  1423. 4.  Choose either Import Ticket Information or Import Action Information,   
  1424.     depending on the data you want to import.  
  1425.   
  1426.     Ticket information and action information are imported separately because   
  1427.     there can be many actions associated with one ticket. In order to keep   
  1428.     track of which actions are associated with which tickets, the ticket   
  1429.     number field is required for importing actions.  
  1430.   
  1431.     After choosing one of the import options, a list of fields displays.    
  1432.   
  1433. 5.  Indicate the layout of the fields in the import file.  
  1434.   
  1435.     This list represents the fields available for import.  The numbers to the   
  1436.     left of each field indicate the order of the fields in the import file.    
  1437.     For example, if you want to import a file which contains ticket number,   
  1438.     priority, status and date (in that order), you would put a 1 next to the   
  1439.     Ticket Number field, a 2 next to the Priority field, a 3 next to the Status   
  1440.     field, and a 4 next to the Date field.   
  1441.   
  1442.     A zero in any field indicates that the field does not exist in the import   
  1443.     file, and it should be ignored. In the example above, a zero would be   
  1444.     placed in all remaining fields. With the exception of the zeros, the   
  1445.     numbers you place in the fields must be unique.    
  1446.   
  1447.     As mentioned above, the ticket number field is required when importing   
  1448.     actions. If the ticket number contains a zero when importing tickets,   
  1449.     then only contact information (and not ticket information) is recorded.  
  1450.   
  1451. 6.  Press the <ESC> key, and choose the Yes option to begin the import   
  1452.     process.  
  1453.   
  1454.     Ticket information must be imported from a file named ITICKETS.TXT, and   
  1455.     actions must be imported from IACTIONS.TXT.    
  1456.   
  1457.     Once selecting the field order and starting the import process, a "Please   
  1458.     Wait" box will appear and the number of records being imported displays   
  1459.     on the screen. If any errors occur during the process, you will be   
  1460.     notified at the end and directed to the file ERRORLOG.TXT for details.  
  1461.   
  1462. 7.  To exit the utility, press the <ESC> key two times.  
  1463.   
  1464.     A box displays with the title "Exit LSC Import/Export Program."  
  1465.   
  1466. 8.  Choose the Yes option to exit the utility.  
  1467.   
  1468. 16.1.2 Exporting LSC Ticket Data  
  1469.   
  1470. Use the following procedure to export LSC ticket data to an ASCII text file.  
  1471.   
  1472. 1.  Load the Btrieve record manager.  
  1473.   
  1474.     Either server-based or client-based Btrieve can be used with the   
  1475.     import/export utility. Refer to section 2.10 for a discussion of the   
  1476.     Btrieve options.  
  1477.   
  1478. 2.  Execute the import/export utility.  
  1479.   
  1480.     Enter the following command at the DOS prompt:  
  1481.   
  1482.     LSCIMEX <ENTER>  
  1483.   
  1484.     The main menu displays.  
  1485.   
  1486. 3.  From the main menu, choose the Export Data from LSC option.  
  1487.   
  1488.     The Export Menu displays.  
  1489.   
  1490. 4.  Choose either Export Ticket Information or Export Action Information,   
  1491.     depending on the data you want to export.  
  1492.   
  1493.     Ticket information and action information are exported separately because   
  1494.     there can be many actions associated with one ticket.  
  1495.   
  1496.     After choosing one of the export options, a list of fields displays.    
  1497.   
  1498. 5.  Indicate the order in which to export the fields.  
  1499.   
  1500.     This list represents the fields available for export. The numbers to the   
  1501.     left of each field indicate the order in which the fields will be   
  1502.     exported.  For example, if you want to export the ticket number, action   
  1503.     code and person, you would put a 1 next to the Ticket Number field, a 2   
  1504.     next to the Action Code field, and a 3 next to the Person field.   
  1505.   
  1506.     In order to keep track of which actions are associated with which   
  1507.     tickets, the ticket number field is required for exporting actions.    
  1508.     It is automatically exported as the first field for actions.  
  1509.   
  1510.     If the ticket number contains a zero when exporting tickets, then only   
  1511.     contact information (and not ticket information) is recorded.  
  1512.   
  1513.     A zero in any field indicates that you want to skip that field during an   
  1514.     export. In the example above, a zero would be placed in all other fields.    
  1515.     With the exception of the zeros, the numbers you place in the fields must   
  1516.     be unique.    
  1517.   
  1518. 6.  Press the <ESC> key, and choose the Yes option to begin the export   
  1519.     process.  
  1520.   
  1521.     Ticket information is exported to the file TICKETS.TXT, and actions are   
  1522.     exported to ACTIONS.TXT.  The files generated from an export will have   
  1523.     quotes around each text field but not around the integer fields.    
  1524.   
  1525.     Once selecting the field order and starting the export process, a "Please   
  1526.     Wait" box will appear and the number of records being exported displays   
  1527.     on the screen. If any errors occur during the process, you will be   
  1528.     notified at the end and directed to the file ERRORLOG.TXT for details.  
  1529.   
  1530. 7.  To exit the utility, press the <ESC> key two times.  
  1531.   
  1532.     A box displays with the title "Exit LSC Import/Export Program."  
  1533.   
  1534. 8.  Choose the Yes option to exit the utility.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.